Function Reference

_AD_GetSystemInfo

Retrieves data describing the local computer if it is a member of a (at least) Windows 2000 domain.

#Include <AD.au3>
_AD_GetSystemInfo()

Parameters

None.

Return Value

Success: Returns an one-based one dimensional array with the following information:
    1 - distinguished name of the local computer
    2 - DNS name of the local computer domain
    3 - short name of the local computer domain
    4 - DNS name of the local computer forest
    5 - Local computer domain status: native mode (True) or mixed mode (False)
    6 - distinguished name of the NTDS-DSA object for the DC that owns the primary domain controller role in the local computer domain
    7 - distinguished name of the NTDS-DSA object for the DC that owns the schema role in the local computer forest
    8 - site name of the local computer
    9 - distinguished name of the current user
Failure: "", sets @error to:
    1 - Creation of object "ADSystemInfo" returned an error. See @extended

Remarks

None.

Related

See Also

http://msdn.microsoft.com/en-us/library/aa705962(VS.85).aspx

Example

#AutoIt3Wrapper_AU3Check_Parameters= -d -w 1 -w 2 -w 3 -w 4 -w 5 -w 6
#AutoIt3Wrapper_AU3Check_Stop_OnWarning=Y
; *****************************************************************************
; Example 1
; Retrieve data about the local computer if it is a member of a Windows domain.
; *****************************************************************************
#include <AD.au3>

; Open Connection to the Active Directory
_AD_Open()
If @error Then Exit MsgBox(16, "Active Directory Example Skript", "Function _AD_Open encountered a problem. @error = " & @error & ", @extended = " & @extended)

; Get the ADSystemInfo
Global $aInfo[10][2] = [[""],["distinguished name of the local computer"],["DNS name of the local computer domain"], _
["short name of the local computer domain"],["DNS name of the local computer forest"],["Is local computer domain in native mode (TRUE) or mixed mode (FALSE)"], _
["name of the NTDS-DSA object for the DC that owns the primary domain controller role in the local computer domain"], _
["name of the NTDS-DSA object for the DC that owns the schema role in the local computer forest"],["site name of the local computer"], _
["distinguished name of the current user"]]

Global $aTemp = _AD_GetSystemInfo()
For $iCount = 1 To $aTemp[0]
$aInfo[$iCount][1] = $aTemp[$iCount]
Next
$aInfo[0][0] = $aTemp[0]
_ArrayDisplay($aInfo, "Active Directory Functions - Example 1")

; Close Connection to the Active Directory
_AD_Close()